Release 10.1A: OpenEdge Application Server:
Administration


Set the agent application mode to production

You must set the value of your agent application mode to Production to prevent unwanted exposure of several WebSpeed components. The default setting is Development. Therefore, you must take explicit action to change to Production mode before you deploy and run your WebSpeed applications.

Table 13–1 details the functionality differences between the production and development modes.

Table 13–1: Agent application mode descriptions 
When the agent application mode is set to...
Then this property...
Production
  • Prohibits Web objects specified in the URL with the path install-path\src\web\ from being run.
  • Disables these utility commands: debug, reset, and ping.
  • Disables access to WebTools.
  • Restricts the utility command ping so that it only indicates that the WebSpeed agent is available; it does not display any other information about the agent’s environment.
  • Ignores debugging via the URL, ?debug=xxx, even if the Debug mode is enabled.
Development (default)
  • Allows unlimited access to run Web objects specified in the URL with the path install-path\src\web\.
  • Enables these utility commands: debug, reset, and ping.
  • Enables access to WebTools.
  • Allows users to access specific development files.
  • Enables debugging via the URL, ?debug=xxx, if Debug mode is enabled.

You can use the Progress Explorer Tool to change the value of the Agent application mode from development to production.

To change the application mode with Progress Explorer:

  1. Double click the WebSpeed folder on the left-hand side of the main Progress Explorer window.
  2. Right click on the broker name.
  3. Choose Properties on the shortcut menu. The broker Properties dialog box displays.
  4. Select on Agent General to display properties associated with the WebSpeed agent. Note that the Agent application mode field displays two options: Development and Production.
  5. Set the Agent application mode to Production:

Another method of changing the application mode from development to production is to edit the ubroker.properties file.

To change the application mode by editing ubroker.properties:

  1. Determine if you need to set all brokers or just individual brokers to a Production mode.
  2. The property values established in the various sections of the ubroker.properties file are governed by a parent-to-child inheritance relationship. For example, values set in the parent, the [UBroker] section, are inherited at the [UBroker.WS] level. Similarly, values defined at the [UBroker.WS] level are inherited as default values by each individual broker instance in the [UBroker.WS.brokername] sections.

    Alternatively, you can retain the property values established at the parent level and override only those individual values at the lower, child level that you need to change.

  3. Search the ubroker.properties file for the srvrAppMode property in the section, or sections, that you need to change.
    • To affect all brokers, search for srvrAppMode property in the [UBroker.WS] section.
    • To affect one or more individual brokers, search for or add the srvrAppMode property in the individual [UBroker.WS.brokername] section.
  4. Change the value of the srvrAppMode property to Production.

Copyright © 2005 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095